home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / util / deskclck.sit / DC_Notes.bin / DC Notes
Encoding:
Text File  |  1989-02-24  |  5.2 KB  |  123 lines  |  [TEXT/EDIT]
  1.  
  2. What it is:
  3.    
  4.    DeskClock is an init which gives you a small analog clock in a window.
  5.    It travels with you from application to application, except under
  6.    Multifinder (see note, below). It keeps track of where you move it,
  7.    and stores this information when you close it or shut down, so that
  8.    it can return to its position on startup.
  9.  
  10. How it works:
  11.  
  12.    DC works like other inits - just put it into your System Folder
  13.    and reboot. (If you hold down the Shift key, DC will not load.)
  14.    
  15.    To toggle the date display, click anywhere on the clock face.
  16.  
  17. Legal Stuff:
  18.  
  19.    DeskClock may be freely distributed as long as it is passed along with
  20.    this document. It is free - keep it if you find it useful.
  21.    However, I reserve all rights to it, and accept no liability arising
  22.    from its use or misuse. (Neat, eh?)
  23.  
  24. Compatibility:
  25.  
  26.  Ñ DeskClock requires new (at least 128K) ROMs. It was tested primarily
  27.    on a Mac Plus, and less-than-extensively on the Mac II and SE. Although
  28.    I can't see any reason for it not to work on a 512KE, I couldn't find
  29.    one to test it on.
  30.  
  31.  Ñ S/W requirements - DeskClock was developed under System 6.0.2 (using
  32.    Consulair's MDS 2.0, incidentally). It also seems to work fairly well
  33.    with 4.1. I wouldn't try it with anything prior to 3.2.
  34.    
  35.  Ñ Multifinder - when used with multifinder, DC remains in the layer it was
  36.    opened in, usually at the finder level.
  37.    
  38.  Ñ A/UX -  Nope. A/UX does not support inits, as far as I know. (Of course,
  39.    no one offered me an A/UX system to try it on...)
  40.    
  41. Bugs:
  42.    
  43.    DC currently does not update the date (at midnight) until you reboot.
  44.    This will be fixed if/when I can figure out how to get the International
  45.    Utilities PACK to work within a driver.
  46.  
  47. The Rest of the World:
  48.  
  49.    Sigh. I tried. I tried to make DC as friendly, as inoffensive, as
  50.    discreet as I could. In this day and age of multiple system versions,
  51.    machine types, displays, Multifinder, etc., this is ... tricky. It runs
  52.    via the _SystemTask call, so it will not show up if this is not called.
  53.    
  54.    Hypercard doesn't seem to like it. (Somehow, this doesn't surprise
  55.    me that much. Bill Atkinson, while obviously a phenomenal programmer,
  56.    has his own idea of "standards" and "compatibility". :-)
  57.    
  58.    ResEdit works fine, but the initial position of its windows seems, in
  59.    some bizarre fashion, to be governed by the placement of the clock.
  60.    (I still haven't figured this one out.)
  61.    
  62.    Apart from these, I haven't run into problems with the applications
  63.    I tried. In no case has DC crashed an application; about the only thing
  64.    I've seen is them abusing it. (I think I fixed that, though.)
  65.    Games, of course, play by their own rules and are another matter 
  66.    entirely. It's probably best to close DC before you run Falcon or
  67.    what-have-you (although Quarterstaff runs without problems).
  68.   
  69.    
  70.    In the short term, you can probably bend my ear through a friend's
  71.    account here at the University of Waterloo,
  72.    
  73.    thfisher@tiger
  74.    
  75.    "Tiger" is just a hop skip and a pounce away from "watmath", which is
  76.    a backbone site for Edunet, CSnet, USENET, etc., so any half-decent
  77.    mailer has a running chance at figuring it out. I should be around
  78.    until March '89, and may be back sometime in September, probably as
  79.    
  80.    rnpantos@crocus, rnpantos@dahlia, or rnpantos@trillium
  81.    
  82.    all on Edunet.
  83.    
  84.    I also read USENET (comp.sys.mac) pretty regularly.
  85.    
  86. Other Stuff:
  87.  
  88.    In keeping with being as friendly as possible, DC is always inserted as
  89.    the rear-most window. This is admittedly a pain when you have a bunch
  90.    of windows; obviously those who can make best use of it are the folks
  91.    who are lucky enough to have large screens. :-)  For those constrained
  92.    to a Mac Plus (as I am), I find that since the 'root' folder of my HD
  93.    is always open, putting DC up in the top right hand corner works fairly
  94.    well. Your mileage may vary.
  95.    
  96.    Since DC exists as a window, rather than writing directly to, say,
  97.    the menubar, it does not conflict with any screensavers, including
  98.    Moire (my favourite).
  99.    
  100.    A note about positioning - if you got a copy of DC from someone with a
  101.    large display (Mac II, Radius, whatever), and it doesn't show up on
  102.    your 9" screen, this may be because they have it somewhere that your
  103.    screen isn't. The easiest way to fix this is to make sure that they move
  104.    it somewhere neutral (i.e. the top left corner of their screen) and 
  105.    close it (to save the position) before they give it to you. If this is
  106.    not possible, you can change the position yourself using ResEdit.
  107.    Open the resource called WPOS. It contains just four four-digit hex
  108.    numbers - the first two being the (x,y) coordinates of the window.
  109.    Change this to something like 0040 0040, quit ResEdit and reboot.
  110.    
  111. Why DeskClock:
  112.  
  113.    No good reason, really.:-)  Someone on the Net asked for such a beast
  114.    (once). I've always wanted to learn to program the Mac, and writing a
  115.    driver seemed like a nice challenge. As well, after 5 years of programs
  116.    for the Mac, I've never seen a window-based clock init. So what the hack.
  117.    
  118.    
  119.    
  120. Roger Pantos
  121. University of Waterloo
  122. (in no way affiliated with the University except as an undergrad, etc.)
  123. February, 1989.